---
title: Astro 사이트 배포
description: Astro 사이트를 웹에 배포하는 방법.
sidebar:
  label: 배포 개요
i18nReady: true
---

import DeployGuidesNav from '~/components/DeployGuidesNav.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import { Steps } from '@astrojs/starlight/components'

**Astro 사이트를 구축하고 배포할 준비가 되셨나요?** 다양한 배포 서비스에 대한 안내서 중 하나를 따르거나 아래로 스크롤하여 Astro 사이트 배포에 대한 일반적인 지침을 확인하세요.

## 배포 안내서

<DeployGuidesNav />

## 빠른 배포 옵션

웹 사이트의 대시보드 UI 또는 CLI를 사용하여 Astro 사이트를 여러 호스트에 신속하게 빌드하고 배포할 수 있습니다.

### 웹사이트 UI

웹 사이트를 배포하는 빠른 방법은 Astro 프로젝트의 온라인 Git 저장소(예: GitHub, GitLab, Bitbucket)를 호스트 공급자에 연결하고 Git을 사용하여 지속적인 배포를 활용하는 것입니다.

이러한 호스트 플랫폼은 Astro 프로젝트의 소스 저장소에 대한 푸시를 자동으로 감지하고 사이트를 빌드한 후 이를 사용자 정의 URL 또는 개인 도메인의 웹에 배포합니다. 이러한 플랫폼에서 배포를 설정하는 경우 다음과 같은 단계를 따르는 경우가 많습니다.

<Steps>
1. 온라인 Git 제공업체(예: GitHub, GitLab, Bitbucket)에 저장소를 추가하세요.

2. **지속적 배포**(예: [Netlify](/ko/guides/deploy/netlify/) 또는 [Vercel](/ko/guides/deploy/vercel/))을 지원하는 호스트를 선택하고 Git 저장소를 새로운 사이트/프로젝트로 가져옵니다.

    많은 일반 호스트는 여러분의 프로젝트를 Astro 사이트로 인식하고 아래와 같이 사이트를 빌드하고 배포하기 위한 적절한 구성 설정을 선택해야 합니다. (그렇지 않은 경우 이 설정을 변경할 수 있습니다.)

    :::note[배포 설정]
    - **Build Command:** `astro build` or `npm run build`
    - **Publish directory:** `dist`
    :::

3. "Deploy"를 클릭하면 해당 호스트의 고유 URL(예: `new-astro-site.netlify.app`)에 새 웹사이트가 생성됩니다.
</Steps>

호스트는 Git 공급자의 기본 브랜치에서 변경 사항을 감시하고 새로운 커밋이 있을 때마다 사이트를 다시 빌드하고 다시 게시하도록 자동으로 구성됩니다. 이러한 설정은 일반적으로 호스트 공급자의 대시보드 UI에서 구성할 수 있습니다.

### CLI 배포

일부 호스트에는 npm을 사용하여 컴퓨터에 전체적으로 설치할 수 있는 자체 명령줄 인터페이스(CLI)가 있습니다. CLI를 사용하여 배포하는 경우는 다음과 같은 경우가 많습니다.

<Steps>
1. 호스트의 CLI를 전역적으로 설치합니다. 예:

    <PackageManagerTabs>
        <Fragment slot="npm">
        ```shell
        npm install --global netlify-cli
        ```
        </Fragment>
        <Fragment slot="pnpm">
        ```shell
        pnpm add --global netlify-cli
        ```
        </Fragment>
        <Fragment slot="yarn">
        ```shell
        yarn global add netlify-cli
        ```
        </Fragment>
    </PackageManagerTabs>

2. CLI를 실행하고 인증, 설정 등에 대한 지침을 따릅니다.

3. 사이트를 빌드하고 호스트에 배포합니다.

    많은 일반 호스트가 여러분을 위해 사이트를 빌드하고 배포합니다. 그들은 일반적으로 여러분의 프로젝트를 Astro 사이트로 인식하고 아래와 같이 빌드 및 배포에 적합한 구성 설정을 선택해야 합니다. (그렇지 않은 경우 이 설정을 변경할 수 있습니다.)

    :::note[배포 설정]
    - **Build Command:** `astro build` or `npm run build`
    - **Publish directory:** `dist`
    :::

    다른 호스트에서는 [사이트를 로컬로 빌드](#사이트를-로컬로-빌드)하고 명령줄을 사용하여 배포해야 합니다.
</Steps>

## 사이트를 로컬로 빌드

Netlify 및 Vercel과 같은 많은 호스트는 여러분을 위해 사이트를 빌드한 다음 해당 빌드 결과물을 웹에 게시합니다. 그러나 일부 사이트에서는 로컬로 빌드한 다음 배포 명령을 실행하거나 빌드 결과물을 업로드해야 합니다.

사이트를 미리 보거나 사용자 환경에서 잠재적인 오류 및 경고를 포착하기 위해 로컬로 빌드할 수도 있습니다.

Astro 사이트를 빌드하려면 `npm run build` 명령을 실행하세요.

<PackageManagerTabs>
      <Fragment slot="npm">
      ```shell
      npm run build
      ```
      </Fragment>
      <Fragment slot="pnpm">
      ```shell
      pnpm run build
      ```
      </Fragment>
      <Fragment slot="yarn">
      ```shell
      yarn run build
      ```
      </Fragment>
  </PackageManagerTabs>

기본적으로 빌드 결과물은 `dist/` 디렉터리에 배치됩니다. 이 위치는 [`outDir` 구성 옵션](/ko/reference/configuration-reference/#outdir)을 사용하여 변경할 수 있습니다.

## 요청 시 렌더링을 위한 어댑터 추가

:::note
[요청 시 렌더링](/ko/guides/on-demand-rendering/)을 활성화하여 Astro 사이트를 배포하기 전에 다음 사항을 확인하세요.

- 프로젝트 종속성에 [적절한 어댑터](/ko/guides/on-demand-rendering/)를 설치합니다. (수동으로 또는 `npx astro add netlify`와 같은 어댑터의 `astro add` 명령 사용).
- 수동으로 설치할 때 `astro.config.mjs` 파일의 가져오기 및 기본 내보내기에 [어댑터를 추가](/ko/reference/configuration-reference/#integrations)합니다. (`astro add` 명령이 이 단계를 처리해 줄 것입니다!)
:::
